ATTR Syntax; Attr filename [permissions] Usage : Examine or 
change the security permissions of a file Opts; -perm = turn off 
specified permission perm^ turn on specified permission -a = 

nna : d - directory file 
J^fiinust w - write permit 
?F"il read permit to public 
jpjjermit to public BACKUP 
f\ Q (\ flit Copies all data from 
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yelccne to the May edition of our monthly newsletter, ye again appeal for your coaaents and for submissions to be 
included in future editions as this newsletter is intended as the newsletter of the 059 user group. j ie continue to 
try to present articles which will be useful to OSS'ers at ail levels of experience. 

I have had a few queries over the last couple of aonths from aesbers who have just begun the venture into 0S9 and 
oredictably are having soae difficulties, so I have decided to coiafflence a series, J 0S-9 Pros The Beginning" ; which 
is aimed at the new QS9 user. Bob Oevries often reainds ae that "it is ail in the aanuai when 1 ask a question at 
our local user group seeling. Whilst this is no doubt true ; I sees to avoid reading the aanual unless it is alaost 
a last resort. The 059 aanual after ail can be a little daunting to begin with, so I hope to guide the new user 
through the learning curve with several references to this aanual. 

Sob Oevries had a call froa Hike Haaland, author of ilvTanvas, of Las Vegas.. Nevada, this week and gleaned soae sore 
first hand information about the KLE (Kenneth-Leigh Enterprises) , CoCo4 I . It has a 68070 (Signetics) CPU, 2 MByte 
RAH, 1.44 HB 3.5 inch drive, and OS9/S3000 kernel in ROM. Hike Haaland is one of the software developers for the 
new aachine, so we should see soae nice software for it. The new aachine is already being produced, and the first 
batch will be given to software developers only, and the computers will be available for purchase in August this 
year. 

Hike also aentioned that version 2 of HVCanvas is ready for shipping, and should be available from Nickoias 
Harentes by the tiae you read this. Purchasers of version ! will be able to buy an upgrade for approximately 
1-15.00. and the new price will probably be $50.00. Contact Nickoias Narentes for sore details. Also read the review 
in the March '90 issue. 

An interesting opportunity caae to Don Berrie recently; when he was able to get iisited access to a raamf rame 
computer which had access to Bitnet, a global information network. It is this network which has provided the 
material about the new coeputers which we have published recently. Those files, of course were kindly provided by 
D eter Edwards, one of our ineabers froa Melbourne. Also available on this network, are a large nuisoer of puoiic 
joaain and shareware programs, but in a strangely encoded tors to sake thes transaittable as textf iie-like 
electronic aail. 

Don has sanaged to 'download 1 soae of these files, and is in the process of decoding Ihea. In due course, they 
will be aade available as part of the National User Sroup public domain collection. The usual conditions for 
copying will apply. 

One of the things which Don has downloaded, is an archive which provides patches to both the SRFDRV and 6SHELL+ 
modules, to enable thea to run faster. When installed, these patches really sake the Hultiview environaent fly. 
In fact, Qon has lined aultiview drawing a screen full of icons (fora his cosaands directory) at 1.2 seconds. This 
compares with 2.S or so seconds with the unpatched versions. There is really still soae life left in the old 6809 



Cheers, Gordon 
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D o curaentatio n f a r ZAP. 

The fo 1 lowing programme is what could be described as a 'home- 
made* disk editor written expressly for the Color Computer 3 and the 
0S9 Level II operating system, Copying by any method, including 
posting on electronic Bulletin Board Systems, for personal or 
educational use is encouraged. Copying for commercial purposes, or for 
sale or resale is expressly forbidden. 

The following equipment and software utilities (which may be 
the proprietory property of other software/hardware vendors) are 
required to successfully operate the programme: 

HARDWARE 

1. 512K Tandy Color Computer 3 

2. OSQ Level II Operating System 

3. High Resolution Monitor 

(The use of a colour monitor is advantageous, but not essential) 

SOFTWARE 

The programme needs, at various times during it's execution, access to 
the following system modules or commands: 

RunB, Syscall, gfx2, shell, xraode t dir, /P or /PI and /W 
Syscall needs to be merged with either Gfx2 or RunB to allow RunB to 
find it. 

The programme requires an unused window descriptor in which to run 
itself. 

To use the programme, copy it to your current execution directory, 
and at the 0S9 prompt, type ZAP. 

-WARNING — WARNING-- WARNING — WARNING — WARNING — WARNING — WARNING — WARNING- 

W This programme performs low level read and write operations W 

A on RBF devices. Use with extreme care. Do not use on media A 

R which is irreplaceable. If you do not understand what a R 

N programme of this nature is used for, do not attempt to use N 

I it. Sector copies, including those from one device to another I 

N are permitted. However use extreme care, as the sector N 

G allocation tables are not updated during this operation. G 

-WARNING — WARNING — WARNING — WARNING — WARNING — WARNING — WARNING — WARNING- 

This documentation should accompany all copies of the programme, so 
that users have access to the address of the authors for advice and 
comments. This project has been supported by the Australian National 
0S9 Users Group. 
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PROGRAMME USAGE 



The programme is started from the command line by simply typing "ZAP" 
with no arguments. The introductory banner is then displayed, together 
with a warning, and the user is prompted to input a device name. 
The device name entered is checked for validity, and if valid, an 
attempt is made to read LSNO of the media currently associated with 
that device. 

If LSNO can be read, the media size bytes are decoded, and the 
user is prompted to enter a sector number. The programme will 
not accept sector numbers larger than the maximum number read from 
the media or less than zero. As soon as an acceptable sector number 
is input, that sector is output to the screen in a matrix 
comprised of 16 rows by 16 two-character bytes, and a menu is 
presented at the bottom of the screen. 

The following list describes the menu items in alphabetical order. 

A - Toggles on and off an ascii decoding of the current 
sector. Only printable ascii characters are printed. 
Non-printable characters are represented by a ' . ' 
character. This ascii mode remains in force until a 
further 'A' is entered to turn it off, 

C - Switches on a simple calculator in an overlay window. The 
calculator only accepts input of the following keys. - 
9, A - F (shifted or unshif ted) , the + (;)-*(:)/ and 
<ENTER> keys. The user may optionally use the <SHIFT> key 
for + and *. The calculator always expects input in 
hexadecimal mode, however the decimal equivalent of the 
calculator is displayed in the bottom half of the overlay 
window. To exit from the calculator mode (at any 
time, even in the middle of the calculation) simply press 
the <F1> key. 

D - Prompts for a change of current device. If the programme 
cannot open the new device, or attempts to open a device 
with a media error, it will terminate and display the 0S9 
error number which caused the problem. When a new device 
is selected, LSNO is read, and the programme again prompts 
for a valid sector number, 

E - Provides access to the 'dir* command to do an extended 
directory of a chosen device. The user is prompted to 
supply a (full) pathname to the directory required. 

H - The help command provides the user with an overlay window 
that shows a (greatly simplified) summary of all of the 
meanings of the individual menu keys. 

I - Shows, in an overlay window, the plain language decoding 
of LSNO for the currently selected media in the current 
device . 

M - WARNING! The * M' command is used to modify the contents of 
the current sector. These modifications are performed 
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initially in memory, When this command is selected, a new 
menu is shown, and a cursor appears on the data area of 
the screen. The cursor is steered around the data area by 
the use of the arrow keys. It operates on the 'closed 
system' principle. That is, if the left arrow key is 
pressed when the cursor is located at byte 0, the cursor 
will jump to byte 255 and vice-versa. The ' V key is used 
to rewrite the current sector, and the user is prompted to 
verify the operation. Pressing 'H* while in modify mode 
will provide a simplified help screen. The sector 
modification routine only accepts pairs of hexadecimal 
numbers, and moves to the next adjacent position after 
each pair of numbers is entered. If the ascii switch is 
toggled on, changes to the sector are NOT shown in ascii 
until after the new data is written to the media. It is 
possible to change any data in any sector on the disk. 
This may make your disk unreadable, or destroy a directory 
or file, or cause an executable file to have a CRC error. 
Be careful ! t 

N - The * N' key is used to select a new sector on the current 
media. Only valid sector numbers are accepted. When a 
valid sector number is entered, the sector data is redrawn 
to show the contents of the new sector. 

P - To print a hard copy of the current sector use the *P' 
command. The programme will look for the device /PI to 
use to print the sector data. If /PI cannot be found, 
the programme will then attempt to use the device /P. If 
the printer is connected, but offline, the user is 
prompted to place the printer online, and to retry. If 
no printer is connected, then (because of a hardware 
feature of the CoCo 3) the programme appears to see a 
printer and passes the data to the printer port. As 
soon as all the data is passed, the programme is ready to 
accept further input. 

Q - Press the * Q' key to exit the programme. On a successful 
exit, all windows and devices are closed, all of the 
programme modules removed from memory, and the user is 
returned to the original screen from which the programme 
was run. In most cases, pressing the <BREAK> key will 
also terminate the programme without messing- up the 
system. 

S - WARNING! This command allows sectors to be copied, either 
from sector to sector on the same disk, or to media in 
another device. Be very careful when using this command. 
The sector allocation table is NOT updated by this 
operation. The user is prompted for verification before 
performing a low-level write. This operation may overwrite 
some of the vital contents of your disk, and make part or 
all of the disk unusable! ! Be very careful. 

<- => - The left and right arrow keys are used to move to the next 
or previous sectors. When located at sector zero, pressing 
the left arrow will cause the highest numbered sector on 
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the disk to be displayed. Similarly, pressing the right 
arrow key when located at the raaxiraura sector causes sector 
zero to be displayed. If the ascii toggle in on, the new 
ascii data is written after each sector change. 

When expecting input from the users console, the programme 
will accept both lower case and upper case letters. If the programme 
terminates with an error condition, an attempt will be made to 
identify the particular error which caused the termination. It may be 
necessary to press the escape key to finally return to the 0S9 
prompt in these circumstances. Extensive error trapping has been 
incorporated into the programme, however, so as to make as few 
assumptions as possible about a user's particular system, we have 
decided not to try to use error number decoding (by looking for 
/dd/SYS/errmsg etc) . 

The programme has undergone a number of substantial revisions 
since the BasicOQ source code for version 1.10 was published in the 
Australian 0S9 Newsletter, and a number of major problems have been 
rectified. The programme will work equally well with hard, floppy, 
or ram disks of any size, and all necessary disk data is always read 
directly from the media in question. Extensive debugging and testing 
has taken place, and as far as we know the programme has no major 
bugs. Further development is contemplated, however new releases will 
be written in ' C , and will be of a more generic nature. 

If you feel that this programme will be useful, and will help 
get you out of trouble, please send $10.00 to give us the incentive to 
keep support for ZAP going, and to keep working on new versions. 
Feedback from users is encouraged, and may be directed to : 

Don Berrie Bob Devries 

25 Irwin Terrace 21 Virgo Street 

OXLEY Qld 4075 INALA Qld 4077 

AUSTRAL I A AUSTRAL I A 

(07) 3753236 (07) 3727816 
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OS-9 FROM THE BESINNIN8 



tie have presented a number of articles in our newsletters designed to help others gam an understanding of this 
operating system, refer to the Newsletter Index in last month's edition. 

For this series I will assume the reader has a Tandy CoCo3 and the Tandy OS-9 Level 2 operating systes. I ail I 
also assume that the reader may have venturec into the Hicroware GS-3 package only to decide that it seems very 
unfriendly and difficult to understand. Perhaps it is Use to retrieve the two OS-9 disks froi* the disk box and 
the manual from the bottom draper. 

1 have used a Tandy 1, 2 and 3, and like »any others.: became reasonably familiar with the built in Basic. Extended 
Basic and then Disk Basic. Ue can run tany commercial programs, and even write our own in Basic or assembly 
language, load files and save files using floppy disks and do &any other interesting things; so why OS-9? 

0S-3 is an operating system, unlike Disk Basic (somet iffsesi referred to as RS-DOS) which is strictly not an operating 
system at ail, so the very first thing to oo is to forget all the Disk Basic commands because the disk access 
cos&ands are only an extension of BASIC. The one command exception is "DG£ n which is a disk basic command used to 
start-up OS-9. 

The Hicroware OS-9 operating system, once booted, will replace Disk Basic in the computer's memory. All 
descriptions of hardware devices, eg. disk drives, serial oori, etc, which were "built in* to RS-QC8, are now gone. 
So for OS-9 to use the hardware devices; it needs a description of each and every device connected to tne system. 

DS-9 has been modelled on UNIX , has a great similarity to UNIX , and will bring a UNIX feel to your favourite 
computer. This is mainly due to the common concept of "Modules* and unified I/O (input/Output). OS-9 is made uo 
of over one hundred small programs or utilities, each designed for one small job and referred to as a "Hodule". To 
add a new device to OS-9, just describe it to the operating system. Bach device needs a "device driver" and 
"device descriptor*. While each separate device needs its own "descriptor 6 , like devices are able to share the 
same D driver\ eg CCSDisk is the "driver" for floppy drives, and DC, Dl, 02 are the "descriptors" for each physical 
drive which each share the CCSDisk driver. OS-9 also uses special class drivers. In DS-9 jargon, a floppy disk or 
hard disk fall into the special class called "Random Block File" (RED devices. However, more on that at a later 
stage. 

The point being that the modular concept of OS-9 allows EACH device to have a unique description. Drive (DC) may 
be 35 track single sided, Drive ] (Dl) may be 40 track double sided. Drive 2 (02) say be 80 track double sided, or 
in fact any combination desired. Each such device must of course have a "descriptor" which matches the physical 

FIRST, take the OS-9 manual and read the first section "Setting Started". Now don 1 t be tempted to go further into 
the next sections, but read "Getting Started" again. Don't worry if it does not all make sense at this point. 

The "Setting Started" section lists hardware requirements as a CoCoS (presumably 128K) and one floppy drive. OS-9 
on such a system is yeeerrry limited and painful at best. A 512K CoCoS with two Double sided drives, 40 or SO 
track is really needed. To boot OS-9 from the disks distributed by Tandy (35 track, single sided format) a 35 tr. 
or 40 tr. single or double sided drive, as Drive (DO) will be needed. CoCo/GS9 will support three floppy drives. 
The disk controller imposes this limit, not OS-9. 

The terms "boot" or "bootstrap", by 5 long standing convention, are simply the terms used for starting up an 
operating system on a computer. 

After only a little use of 0S-S it will be noted that the system is very disk intensive. That is, the system 
accesses the disk drives frequently for the commands and files it needs to perform the requested tasks. Frequently 
used command modules can be loaded into memory to reduce disk access and speed things up, but, once again, sore on 
that later. 

An RSDQS disk has only one directory (stored on track 17) and ail files stored on the disk are recorded in this 
directory, while an OS-9 disk can have many directories and many levels. "Levels" there is a new concept. 0S-S 
uses a hierarchai directory system, and it is very important to understand this concept. Much like a family tree 
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or sometimes described as an upside down tree with its "root" at the t-op. To get to any branch of the tree ye must 
start froa the "root" 

The Root directory on a disk could be called the highest level, or referred to as the first level accessed. It 
does not have a naae as such. To see the contents of the "root" directory of a disk in drive 0, type "dir /d0\ 
if the disk sere in drive 1, type "dir /d!\ The root is the first directory read by the device. 

The next aost important concept to understand about disk files is the way OS-3 uses TWO directories in its 
operation the DATA directory and the EXECUTION directory. When OS-3 is booted, the data directory defaults to /dO 
and the execution directory defaults to /'dO/CMDS (this assuraes that OS-3 is booted froa the floppy drive 0). The 
execution directory "CMD3 9 contains executable modules which may be systea utilities or prograa aodules. ¥hen a 
coaaand is entered at the 0S9: prompt , OS-3 will first look in seaory for a module naae which matches and if no 
aatch is found it sill look in the current execution directory and lastly will look in the current data directory. 
Once OS-3 finds the aoduie, it will attempt to execute that aoduie if in aeaory, or will load the aodule froa disk 
and then execute it. 

Perhaps the aost coaaon error reported by OS-3 is ERROR 216 (Path Name Not Found). 

This error say aean that the file or "module 11 that has been asked for ; either froa the keyboard or another prograa, 

does not exist, OR, lore coaaonly, the file does not exist in the current DATA or EXECUTION directories. 

Now the DATA and EXECUTION directories need not reaain pointed to /dO and /dO/CMDS as these can be changed to any 
valid (existing) directory. eg. chd /dO/CHDS would change the current DATA directory to the CMOS directory on 
Drive 0. Yes, the data and execution directories can be pointed to the saae directory. The DATA directory is also 
often referred to as the WORKING directory (the saae directory by a different naae) The coaaand ?yD or pwd will 
report the current WORKING or DATA directory. 

What is a "pathname"? Files or nodules which are not in the current directories say be located by OS-9 if the 
correct "pathname" is given. "Pathnaae" is sirapiy the "path" in the directory or tree structure, eg. the coaaand 
line list /dO/SYS/errasg would work provided the file "errasg" was in the directory SYS which is at a root" level 
on the disk in DO. 

OS-3 assumes thai any filename entered at the OSS : proapt is an executable aodule. It first looks in seaory for a 
module of that naae, if not found, it will look in the current execution directory, and if not found, it will look 
in the current data directory, if not found, sill report ERROR 1216. 

Notice that OS-3 is not "case sensitive", inlands entered in lower case are treated identically to coaaands 
entered in upper case. This also aopiies to file nases ana directory naaes, however oy convention, uoper case 
should be used for all directory and sub-directory names, and lower case used in naaes of ail single files within a 
directory. This convention aakes it easy to distinguish between directories and files, eg The rooi directory of 
disk 1 of the level 2 distribution disk looks like this ;- 



nippffijfy ftf 


/dO 


OSSBoot 


CUDS 


window. tSSs 


window. tSOs 



SYS startup 
window. glr4 aakecopy 

with the exception of n QS3Bcot\ a special OS-3 file, we can tell at a glance that a CriDS n and D SYS n are the only 
two directories at the a root" level. Each of the others is a single file. 

OK. "Getting Started" Chapter 2 (pages 2.1 - 2.5) gives all the necessary instructions to "boot" OS-3. At the 
■'Tiae? a proapt enter the date and time, do NOT just hit (Enter) as the tiae is important to the operating systea. 
One short cut is to leave out the delimiters, eg 30040121SO works just the saae as 30/04/01 21:30. Two digits 
aust be used for each item . 04 for the fourth month, NOT 4. 

Assuming that 0S-3 has booted O.K. we now have the operating systea running with the default (as distributed) 
hardware descriptions. If this does not suit the capabilities of hardware connected to the systea we aust set 
about correctly describing the "devices 9 to OS-3. ye would also like to sake these descriptions peraanent so that 
when the operating systea is booted, the correct descriptions will already be in place. 
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dOSS I&DOSS S0f!,S 1 isl t-StI0"S . 

H G8tt ino Started"' Chapter 7 iiim page 7.1) gives all the detailed instructions . The floppy drive descriptors to 
iiiaUh the HAXIHUh capabilities of the system's drives should be selected . OS-3 is s^art enouoh to read and write 
to flooov disks of any lesser cauautv. For example, the descriptor for an SO track oouble sided drive as Drive i 
vvou 1 d be D! SOD . Once the svsteii; is booted with this descriotor included m the DSSBoot file, Drive 1 would 
haDDiiv read and write to a disk formatted as 40 track douole sided, sinole sided OR 35 track double sided, sinole 
sided. 

Do not include the descriptor 7! (it won't work very well on the CoCo3). 73 is Drobably not such use either, so 
don't include this one. Ml and M2 are for the 7andy Hodein Pak, not sold in Australia to sy knowledge, so leave 
t.rje=is out also (Note, the Tandv - C 2 3 2 Pak is net the sar^s as the Hodesi Pak ) 

Include all the sindow descriptors w\ w 1 ] - 17 (512k system assumed) and a lFJULL cosinand set. Config will create 
a boot= lie, GS?Bcot even if i^JG cosisan-Qs h?? selected, however as a lamiaus. for a tootaoie disk it siust contain a 
CMOS directory which contains the modules "Shell" and H Sr?Drv\ Actually "GrfDrv" is only required if windows are 
used, and of course GS-9 Level 2 windows are the kev to useful feultitaskinq. 



;a^ be noted that a drive descriotor for an SO track double sided drive as Drive is not included in the driv 
:tions. Should such a descriptor be needed, we can show you hoy to Kai 
oatch E for one of the existino descriptors which will convert it to suit. 



selections. Should such a descriptor be needed, we can show you hoy to inake one, op &ore correctly, we can suopr 



Once a new n Boot !! disk is created, the OS-S operating system will be running and all hardware in the system will oe 
fully available for the application programmes and multi-tasking that sill follow. 

The "config" program calls OSSGen to create a bootable disk. QS9£en will write the "Kernel" on track 3i of a 
floppy disk as well as create the GSSBoot file. Because the Kernel sust be in a specific location on the disk, and 
the OSSBoot siust use contiguous sectors ; it is best to use a freshly formatted disk as the destination disk for 
confio. Chapter 1 of the "OSS Cufn^ands" section beoins with s description of the "Kernel" nodule and describes 
other important modules. 

Do not expect too much at this point. Reseaber that OS-S is not a program, it is an operating system under which 
sany programing languages can be used. BasicOS (a for* of Basic), pascal, C, Assembler, Fourth, and Logo to naae 
a few. 

Next ionth we will begin to explore so&e of the feulti-tasking abilities of DS-3. Please let s>e know if you are 
having any difficulties in creating a Boot to suit your system. 

Gordon Bentzen 
ooooooooooGOOOOODDOOoooooooooo 

Additions and Alterations. 
Bv Bob Devries. 

Those of you who typed in last lonths listing of 'CC3So' could have run into trouble if you did not have the 
correct definitions file. It was pointed out to fee by a local Brisbane user, that not all users out there have the 
newest version of the definition file 'GSSDefs 1 . The version I use case fro$ the Development System disk (side E). 
It has the defs file that was modified for use with 059 Level II. For those of you who do not have this file, two 
changes need to be made to the ' CC36o l listing. 
Both changes may be aade at the beginning of the file, say at line 7, and you should add these lines :- 

D.SysFrc eou $4A 
D. Crash equ $6B 
Please note, that when you assemble this file, you'll get a U warning message at the line that has the ! jso 
D. Crash 1 in it. This is because it is illegal in normal OSS programing to use a juap instruction or any other 
direct RseEory access instructions. In this case, however, QSS has crashed anyhow, so it no longer (natters. 

uffiilst I a* w"itinG about chanoes to detmitions =iies- there is another one that needs chanoiro Tnat one is the 
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sdefine F_Nf1LINK 0x2; it CoCo Hon maoDing Link ti 

idefine F NHLOAD 0x22 it CoCo Non ffiaDpina Lead ti 

tdefine F VIRQ 0x27 it 1 nstal I / delete Virtual IRQ */ 

tdefine F SCMDI R 0x52 It Pack Nodule Directory %! 

tdefine F_ALHRAH 0x53 it Allocate High Rani Blocks XI 

tdefine SS_ALFAS Oxk IX Return Alpha Display Statue (CoCo SCF GetStat) XI 

idefine SS CURSR 0x25 /+ Cursor Information for CoCo */ 

tdefine 38 SC8II 0x26 it Return screen size for CoCo ti 

tdefine So KYSNS 0x27 /* Get/FutStat for CoCo Keyboard %/ 

Idefine SS CQHST 0x28 It Get/PutStat for Baud/Parity -7 

Ei-iafirii : -. r -'. iq£PP Ovi-ifi ft PijfQijf t -i a'i'ifiriti ^^Hfinj! nr-inhir rtiifior- i' / 

idefine SS SLGBF OxSI IX PutStat to select a different buffer ti 

tdefine SS_MPGFB 0x84 It Sei/PutSiat to reouest buffer to be capped to the workspace %! 

idefine S3_UNSET 0x86 it Set up high level windowing information t! 

tdefine SS HNSEL 0xS7 /+ Request hion level window handler to determine next event XI 

tdefine SS SBAR 0x83 /* FuiStat to position window scroll bars tf 

tdefine SS_HGUSE 0x83 IX Return f&ouse information packet (CoCo) %! 

tdefine SS_NSSIS 0x8a it PutStat- to tell driver to send signal on mouse event XI 

idefine SS ASCRN OxSb /+ Allocate a screen for application Dokino ti 

tdefine SS D3CRN 0x8c It Display a screen allocated by SS_ASCRN XI 

tdefine SSJ3CRN 0x3d ft Free a screen allocated by SS_ASCRN ti 

idefine SS PSCRN OxSe It Polymorph screen into a different screen type !/ 

tdefine SS_FALET 0x3] it Return Palette information ti 

tdefine SS_h'0NTR 0x32 IX Get and Set Monitor type +/ 

idefine SS_SCTYF 0x33 IX Get screen type information XI 

Idefine SS_GIF 0x34 It Global Input Parameters XI 

tdefine SSJJHEAR 0x35 IX Update Henu Bar SetStat XI 

# d s f i n 8 SS FBRGS 0x36 It Return Colour registers GetStat XI 

define SS_DFFAL 0x37 It Set/Return default palette registers XI 

tdefine SSjONE 0x38 it Generate tone using 6-Bit sound XI 

ooooooooooDGDGGGDOQGoooooooooo 

Finding information about your files. 

By Bob Devries. 

For a long Use now, I have wanted to find out the details of the data stored in the file descriptor sector of &y 
files, and not Just the modified date, starting sector, and length as : dir e* reports it. yell, I thought that 
rather than buy a proura^e, it would be easier and snore educational to write sy own. So here it is. Tyoe it in, 
and compile it. and you'll own a very useful tool for your CSS toolbox. 

To use fileinfo, either type 'fileinfo file 1 , where file is any CSS pathname; or pipe the output of a programme 
like 'Is 1 or 'd' to it like this:- 

1s ! fileinfo -z 

Bob Devries. 
IX Fileinfo. c - by Bob Devries XI 
IX Find file header information XI 
linclude <stdio.h> 
include <direct.h> 
tinclude <os3.h> 
FILE $fp, ifopenO; 
struct fildes desc; 
sidini Erqc ,arqv) 






iVL j 



Page 10 May 1990 



AUSTRALIAN 0S9 NEWSLETTER 



ulu6u - rHu^i 



*Dlr 



nsi 



.. . -i- __* .. + 1 - ,' ■■, 

E: - T *vt i-2 i.- I: '■■ - : 

?y til Hfidoit L 



t! HO ! 



(argc — <2) { /$ check if the right parage are passed ti 
Duis'-'UsBos; fiieinfo file [file] ..."); 



liemfo -z to 



exii(O); 



((ePQv[]]E03 == l ~ ! ) aS (toupp9r(arqv[] ][] j) == 'Z ; )) 
piped = TRUE; it -z paras so use read si-din for fiiena&es 1/ 
{ 

strcpyiattf , n dse^rewr n ) ; 
if Coioed) i 

if M f cjeiB ; f i iena^e^O ,5i.din] .) == NUlL) { it read si-din 1/ 

piped = FALSE; 

break ; 



f i ienafKe[5trIen(f i lena&e)"] ] = ! \0M it remove CR char frois na&e t! 
) else [ 

st-rcpy ( f i lenaffie . arqvlarqptr 3 ) ; /+ if not si-din use coiiissnd line parafus ti 

if ((fp = fopen(fiIenase J I T H )) == NULL) t it try to open filename as a file %! 
if(up = f ooenu i iena&e . ,; d !1 M =~ NULL) { it if that fails, trv o^ectorv read t- 
fprintf (stderr, E \nCan' i open Is\n% filename); It else report failure ti 
arap tr++ j 
continue; 



if C ( f seek (fp,0I,2))== -1) it seek to end of file ti 

fprintf (stderr, "Something wrong! Can't find end of file ss.\n a , f iienaEe); 

pos = fteii(fp); it get number of chars in file XI 

printf ( n \nInfo on file Ss.\n H ; f ilena&e); 

pnntf( B \nOSS reports that file is lid (1*1)0 bytes long.\n K J pos ! pos); 

readfd(); it read file descriptor sector ti 

printf ( n \nFile descriptor information follows ;\n\n"); 

printfCFile attributes are : Xs.\n II ,getatt.r(attr J ds5c.fd_aU)); 

printf ( "File owner is ^s.\n R f desc.fd_oyn==0 ? "SuperUser" : uloa(desc.fd_own ; s)); 

printf ("File was last updated on £02d/S02d/S02d at 
*02d;*02dAn%desc.fd_dateLO] F desc.fd_date[]] f desc.fd_date[2],de5c.fd_date[3j J desc.fd_d3te[4]): 
/+ the previous 2 lines should be typed in as one line tl 

printf ( "File link count is Sd. \n ,f , desc . f d_l ink ) ; 

printf ("File size is %\d. \n\desc.fd_fsize); 

pnntf( E File was created on *02d/*02d/*02d.\n\dese.fd_dcr[OL desc . f d_dcr[ !j ; desc.fd_dcr[2]); 

ptr = elsn; 

for(i=0; i<48; i++) { it print segment list ti 
13tol( ptr, desc . fdseqii] .addr, ] ); 
if(lsn) i 

printf ( "Used "u Is, starting at LSN Sid (*!UA).\n 1! pdesc.fdsegEil. size, (desc. fdsegliJ. size > ] 
"sectors : "settorMsn.lsn); 
/+ the previous 2 lines should be typed in as one line ti 
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IcIoshUd)! It close the file %! 
3 while (?.-- aroc) !i v oiped) ) ; /I: and continue 1/ 

char iuiod(nuf;:Der: string; it unsigned to asc 2 : conversion modified frora K h R itosO function i, 
unsigned number; 
char stringL 3 ; 

; 

: _ i : : 
I ! U- 1 : 

unsigned sign; 
if ((si on = number) ( 0) 
number = -number \ 

" - ! 
dO i 

st.rinqiit+3 = number £10 + ! 0' ; 
] while ((number /= 10) > 0); 
if (sign < 0) 

slring[it+] = '- 1 ; 
sir i nqE i3 = ! \0' ■ 
reverseistring); 
return(sirinq); 

reverse(s) 



for (i=G, j=sirlen(s)-l ; i<j ; i+-s j--) { 
c=s[:2; 

SLiJ = Si ill 

5ijj=c; 

} 

char igeiaUr(aUr.byi-e) It fros a attribute byte ; return a string with chars set or ! -J +/ 
char sttrEl; It e.g. — ewrewr ?/ 
char byte; 
t 

int i, i t k; 

for (i=0 ; j=':2S; r : 8 ] i++,;l/=2' £ /I siust use j/=2 here NOT -) De-cause of siqn extension ?/ 
k = byte h j; 
if(!(k)3 /? if bit not set, insert a ; - ! char if 

. i + _, r : T _ i I i 
ittfllj - ~ , 

} 

return(attr); 
3 

readfdO /+ read the file descriptor sector into the structure, using the 6ETSTT SS_FD call ti 
[ 

struct registers regs; 

regs.rg_a = filenoifp); It a = path number X! 

regs.rq_b = SS_FD! it b = function number tl 

regs . rg_x = Sdesc) It x - address of kefcory packet t! 

regs.rg_y = sizeof (desc);/? y = number of bytes of packet XI 
regs . rg_u = 0; 

os9(I GE7ST7,&reqs3; />' didn't check for errors here, if error, OSS sust have crashed t 
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